home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / tw3.zip / TW.DOC < prev    next >
Text File  |  1992-10-13  |  94KB  |  2,419 lines
  1.  
  2.  
  3.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  4.  
  5.  
  6.     
  7.     
  8.     
  9.     
  10.     
  11.     
  12.     
  13.     
  14.     
  15.     
  16.     
  17.     
  18.     
  19.     
  20.     
  21.     
  22.     
  23.     =====================================================================
  24.     
  25.                            User Documentation for
  26.                               TreeWalker V3.00
  27.                                   (TW.EXE)
  28.     
  29.                             A Utility Program By
  30.                                  Steve Dunn
  31.                               50 Hillside Drive
  32.                              Hanover, MA. 02339
  33.                           CompuServe ID: 70034,2454
  34.     =====================================================================
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.           Page: 1 of 39 --------------------- Last Revised: 10/13/92
  64.  
  65.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  66.  
  67.  
  68.                             ╔═══════════════════╗
  69.                             ║     T A B L E     ║
  70.                             ║        O F        ║
  71.                             ║  C O N T E N T S  ║
  72.                             ╚═══════════════════╝
  73.     
  74.     
  75.         Section:                                                Page:
  76.     
  77.         Introduction ............................................  3
  78.         Distribution ............................................  4
  79.         Getting Started .........................................  5
  80.         Using TREEWALK.INI to change defaults ...................  9
  81.         The Initial Screen ...................................... 10
  82.     
  83.         Using the TREE Manager .................................. 13
  84.             HELP ................................................ 13
  85.             MKDIR (make a new directory)......................... 13
  86.             DRIVE (choose a new drive)........................... 14
  87.             RMDIR (delete a directory and all its files)......... 14
  88.             PATHS (display as path NAMES or as TREE)............. 15
  89.             SEARCH (for file, global) ........................... 15
  90.             DELETE (file(s) - global) ........................... 15
  91.             PRINT (path NAMES or TREE) .......................... 16
  92.             STATS (on current drive) ............................ 16
  93.             LOAD  (invoke FILE MANAGER) ......................... 17
  94.     
  95.         Using the FILE Manager .................................. 18
  96.             General Introduction ................................ 18
  97.             HELP ................................................ 21
  98.             COPY (one or more files) ............................ 21
  99.             MOVE (one or more files) ............................ 21
  100.             VIEW/EDIT (work with file) .......................... 22
  101.             MARK (one or more files) ............................ 23
  102.             MASK (limit display of files) ....................... 24
  103.             DELETE (one or more files) .......................... 25
  104.             PRINT (listing of files displayed) .................. 25
  105.             CHANGE (file name or attributes) .................... 25
  106.             SORT (files being displayed) ........................ 26
  107.             SHELL (invoke DOS SHELL) ............................ 26
  108.             4DOS / NDOS Features ................................ 27
  109.     
  110.         Program Limitations ..................................... 28
  111.         Tech Note ............................................... 29
  112.         Revision History ........................................ 30
  113.     
  114.         Appendix A  - Quick Reference to TW Parameters .......... 32
  115.         Appendix B  - Map of Color Values in TREEWALK.INI ....... 33
  116.         Appendix C  - Using Printer Control Codes in TREEWALK.INI 37
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.           Page: 2 of 39 --------------------- Last Revised: 10/13/92
  126.  
  127.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  128.  
  129.  
  130.     Introduction:
  131.     ------------
  132.     
  133.             TW.EXE is intended as a full-featured and easy-to-use DOS
  134.     File Manager and Disk(ette) Manager.  It features a "point-and-shoot"
  135.     environment and simplified menus of various functions.  On-line help
  136.     is available at various points during program execution by pressing
  137.     "F1".
  138.     
  139.             You should received the following files for this version:
  140.     
  141.             TW.EXE          - the main executable program file
  142.             TW.DOC          - the ASCII text user documentation (this
  143.                               file!).  If you wish, you can print this
  144.                               file via the DOS command COPY TW.DOC PRN.
  145.             TREEWALK.INI    - a sample configuration file for TW.EXE
  146.             README.1ST      - some rudimentary notes in ASCII format
  147.             TW_INI.*        - alternate color schemes - just rename one
  148.                             of these to TREEWALK.INI to try them out.
  149.     
  150.             In general, all program functions are activated either by
  151.     pressing one of the FKeys or, where there are subsequent menus, by
  152.     pressing the letter or character key contained in the square brackets.
  153.     
  154.             TW.EXE was originally intended to help new DOS users learn
  155.     how their disk(ette)s are organized, how to use the "TREE" structure,
  156.     etc. and to simplify various DOS-level file management capabilites.
  157.     
  158.             TW.EXE V3.00 requires a CGA/EGA/VGA etc (i.e., no monochrome
  159.     adapter cards), and DOS V2.00 or higher, but is otherwise designed to
  160.     work on any MS-DOS / PC-DOS PC system - it uses no undocumented DOS
  161.     or BIOS calls.  It may, however, cause screen "snow" on older PC CGA
  162.     displays (sorry about that!).  It requires a minimum of 320K free
  163.     RAM, and will handle 300 sub-directories per drive, and 700 files per
  164.     sub-directory.
  165.     
  166.             TW.EXE will run under both plain old DOS, or either 4DOS
  167.     (from J.P.Software) or NDOS (licensed from J.P.Software by Symantech
  168.     as part of the "Norton Utilities").  If you do run 4DOS or NDOS,
  169.     additional TW features will be available, specifically supporting the
  170.     "file commenting" features available under either of these two fine
  171.     products.  TW V3.00 may be run under Microsoft Windows (V3.00
  172.     or V3.1) either as a full screen or as a windowed application.
  173.     
  174.             I hope you enjoy using it as much as I enjoyed writing it.  I
  175.     would sincerely appreciate any and all feedback you may have
  176.     (comments, criticisms, suggestions for future versions, etc).  Just
  177.     drop me a line on CompuServe electronic mail (see title page).
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.           Page: 3 of 39 --------------------- Last Revised: 10/13/92
  188.  
  189.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  190.  
  191.  
  192.     Distribution:
  193.     ------------
  194.     
  195.             Despite a strong temptation on my part, TreeWalk V3.00 is
  196.     *not* being distributed as "ShareWare".  You may use TreeWalk V3.00
  197.     for any non-commercial purpose without paying any required fee.
  198.     
  199.             At the same time, I'm sure you'll realize that TreeWalk
  200.     required a substantial amount of time and effort to design, develop,
  201.     debug, etc.;  if you use TreeWalk on a regular and continuing basis,
  202.     please help me to continue to support and improve the product - "A
  203.     contribution in any amount (see address on page 1) would be greatly
  204.     appreciated".
  205.     
  206.     
  207.             V3.00 of TreeWalk may be copied and distributed freely,
  208.     subject to the following conditions:
  209.     
  210.     <>      You make *NO* changes to any of the files, and
  211.     
  212.     <>      You MUST distribute at least TW.EXE, TW.DOC, TREEWALK.INI,
  213.             README.1ST *together* and *unaltered*.
  214.     
  215.     
  216.     
  217.           THIS PROGRAM IS BEING MADE AVAILABLE ON AN "AS IS" BASIS,
  218.            WITHOUT ANY GUARANTEE OR WARRANTY, EXPRESS OR IMPLIED,
  219.                 INCLUDING FITNESS FOR ANY PARTICULAR PURPOSE.
  220.     
  221.               YOU USE THIS SOFTWARE STRICTLY AT YOUR OWN RISK.
  222.     
  223.            UNDER NO CIRCUMSTANCES WILL I BE LIABLE TO YOU FOR ANY
  224.                     DAMAGES OF ANY SORT WHICH MAY RESULT
  225.                        FROM YOUR USE OF THIS SOFTWARE.
  226.     
  227.     
  228.             In any event, I have beta-tested the initial releases of this
  229.     program both locally (on mainly IBM / Compaq hardware), among users
  230.     with varying degrees of PC experience (Thanks Kathie, Eleanor, Linda
  231.     and most especially, Neville!).  This release has been largely shaped
  232.     by the combined feedback of the initial users, plus all the fine
  233.     folks in the electronic BBS world who have so graciously shared their
  234.     opinions with me (Thanks Dianne, Mark, Mike, Dennis, Jeff, Eugene, et
  235.     al!).
  236.     
  237.             Technical support for TreeWalk is available via CompuServe
  238.     E-Mail [70034,2454], or regular mail / postcards;  I'm sorry to say
  239.     that I do not have a phone line for TreeWalk users to call directly
  240.     (yet!).
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.           Page: 4 of 39 --------------------- Last Revised: 10/13/92
  250.  
  251.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  252.  
  253.  
  254.     Getting Started (see also Appendix A for Quick Reference):
  255.     ---------------
  256.     
  257.             TW.EXE is invoked from the DOS command line simply by typing
  258.     "TW" and pressing <enter> - note that all of the following command
  259.     line parms (except for drive spec and the "HELP" parm) can, as of
  260.     V2.01(and higher), also appear in a DOS ENVIRON variable in the
  261.     format:
  262.     
  263.                        set TREEWALK=/parm1 /parm2 ...
  264.     
  265.     or, as they would appear on the DOS command line (and note that parms
  266.     on the DOS command line supercede parms set in the ENVIRON variable):
  267.     
  268.                     TW [d:|.] [/parm1] [/parm2] ... <enter>
  269.     
  270.             d:      - is optional, and represents the drive spec to start
  271.                     with.  If you omit this parm, the current default
  272.                     DRIVE (and the current default PATH) will be used
  273.                     automatically.  In fact, the colon character is also
  274.                     optional.
  275.     
  276.                     - The DRIVE or the "." must be the FIRST parm after
  277.                     the TW (if you plan to use this optional parm at
  278.                     all).
  279.     
  280.                     - Note that if you use a period character,
  281.                     TW will start up and immediately enter the FILE
  282.                     MANAGER for the current default drive and directory.
  283.     
  284.                     - If you DO specify a drive letter, TW will start
  285.                     up in the ROOT directory of the given drive.  TW will
  286.                     still work if you specify a PATH, however, the
  287.                     initial hilite bar will be on the ROOT directory of
  288.                     whatever drive starts the PATH you specify instead of
  289.                     whatever sub-directory you happen to be in when you
  290.                     start the program.
  291.     
  292.                     - If you WANT to start in the ROOT, even of the
  293.                     current default drive, use "d:\" (note the trailing
  294.                     "\" character).
  295.     
  296.                     - NOTE:  TW will check drives "A" and "B" to
  297.                     be sure they are "ready" (i.e., they contain a
  298.                     valid disk, the drive door is closed, ect) first; if
  299.                     not, TW will warn you.  TW assumes that any other
  300.                     drive is *always* "ready", and does not specifically
  301.                     check.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.           Page: 5 of 39 --------------------- Last Revised: 10/13/92
  312.  
  313.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  314.  
  315.  
  316.     Getting Started (continued):
  317.     ----------------------------
  318.                     - However, TW WILL check to be sure that the drive
  319.                     letter you give is, in fact, recognized as a drive on
  320.                     your system.  If not, TW will terminate and display
  321.                     an error message which specifies which drives it can
  322.                     accept.
  323.     
  324.                     - In general, this parm should be used only to start
  325.                     by reading a drive other than the current default
  326.                     drive.  (You will be able to change drives later,
  327.                     from within TW, if you wish).
  328.     
  329.             /parm1,
  330.             /parm2  - are all optional, and may be any of the following,
  331.                     in any order you want:
  332.     
  333.             /25     - forces TW to start in 25 rows-per-screen mode.
  334.                     This is the default mode.
  335.     
  336.             /43     - forces TW to start in 43 rows-per-screen mode.
  337.                     This works only if your system has an EGA adapter or
  338.                     better.
  339.     
  340.             /50     - forces TW to start in 50 rows-per-screen mode.
  341.                     This works only if your system has a VGA adapter or
  342.                     better.
  343.     
  344.             NOTE:   If you specify more than one of the above, TW uses
  345.                     the highest row value it finds on the command line.
  346.     
  347.     
  348.             /R      - forces TW to physically re-read the disk(ette) TREE
  349.                     structure as it starts up.  The default is to *NOT*
  350.                     physically read the disk(ette) tree structure, but
  351.                     rather to read the directory structure TW stored on
  352.                     disk from the last time it was used.
  353.     
  354.                     - When TW is started for the first time, it will
  355.                     automatically save two files to the ROOT directory of
  356.                     the drive being read which will contain the DOS TREE
  357.                     structure data (only for drive C: or higher - it will
  358.                     not save tree structure files for drive A:  or B:).
  359.     
  360.                     - Subsequently, when you start TW, it will read the
  361.                     directory structure data contained in these two files
  362.                     rather than go thru the time consuming physical disk
  363.                     read.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.           Page: 6 of 39 --------------------- Last Revised: 10/13/92
  374.  
  375.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  376.  
  377.  
  378.     Getting Started (continued):
  379.     ----------------------------
  380.                     - You may want to force this physical re-read if you
  381.                     have created or deleted any directories under DOS, as
  382.                     opposed to using TW for this purpose.
  383.     
  384.                     - This function can also be toggled "on" or "off"
  385.                     from within TW, after you have started it (see also
  386.                     "/NS", below).
  387.     
  388.                     - Incidentally, these two files are named "TW!.DAT"
  389.                     and "TW!!.DAT", and are text files.  You can view
  390.                     them using TYPE or LIST, or even COPY them to the
  391.                     printer if you wish.
  392.                     - NOTE: if your printer does not support graphics
  393.                     character printing, the results may be less than
  394.                     satisfactory!).  See "F8" in TREE MANAGER, below.
  395.     
  396.     
  397.             /NS     - prevents TW from saving the "TW!.DAT" and
  398.                     "TW!!.DAT" files (see above) to disk.  This option is
  399.                     included for completeness, but I don't use it myself.
  400.     
  401.                     - Note that TW must do a *physical* (i.e., time
  402.                     consuming) disk read of the DOS TREE structure each
  403.                     time it starts unless it can find the "TW!.DAT" and
  404.                     "TW!!.DAT" files.  These files are always located in
  405.                     the root directory of the drive being accessed.
  406.     
  407.                     - Note that this feature can be toggled "on" and
  408.                     "off" from within TW.EXE, but the default is that
  409.                     TW.EXE *will* save these two files (see also "/R",
  410.                     above).
  411.     
  412.     
  413.             /?      - this parm causes TW to display on the screen info
  414.             /HELP   on what all the available parms do - kind of
  415.                     on-line help for the start up parms.
  416.                     - NOTE:  you cannot specify this parm in the DOS
  417.                     ENVIRON "TREEWALK=" string.
  418.     
  419.             /M      - this parm causes TW.EXE to start up in monochrome
  420.                     mode (the default is in color).  This is useful if
  421.                     you normally use a laptop or other monochrome system
  422.                     (thanks, Mike!).
  423.     
  424.                     - NOTE: If you use "/M" in the "TREEWALK=" DOS
  425.                     ENVIRON string, this "/M" parm CANNOT be superceded
  426.                     by any command line parm.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.           Page: 7 of 39 --------------------- Last Revised: 10/13/92
  436.  
  437.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  438.  
  439.  
  440.                     - NOTE: If you use "/M" on the TW command line, any
  441.                     color assignments you may have made in the
  442.                     TREEWALK.INI file will be superceded.
  443.     
  444.     
  445.             /ASK    - this parm causes TW.EXE to always ASK you what
  446.                     program file to use for the file viewing / editing
  447.                     function available from within the FILE MANAGER by
  448.                     pressing either ENTER or F4.
  449.     
  450.                     - In addition to specifying a different program to
  451.                     use for each file you hilite in the FILE MANAGER,
  452.                     this option also allows you to set various command
  453.                     line parms (if any).
  454.     
  455.                     - This parms may also be set in the "TREEWALK=" DOS
  456.                     ENVIRON string.  Using the command line parm makes
  457.                     this change temporary (for the current TW session
  458.                     only).  Using the environment parm makes this
  459.                     behavior change affect all future sessions of TW
  460.                     until you change the ENVIRON string, or until you use
  461.                     /NOASK on the TW command line.
  462.     
  463.     
  464.             /NOASK  - this parm exists mainly to allow you to override
  465.                     the /ASK parm when it is set in the DOS "TREEWALK="
  466.                     ENVIRON string.  In general, if you /ASK and /NOASK
  467.                     together on the TW command line, the /ASK parm will
  468.                     be ignored.
  469.     
  470.                     - The /NOASK parm cannot be set in the DOS
  471.                     "TREEWALK=" ENVIRON string, since this is the normal
  472.                     default behavior for TW.EXE.
  473.     
  474.     
  475.             In general, TW will evaluate and implement your desired
  476.     options in the following sequence,
  477.     
  478.                     [1]  The "TREEWALK=" DOS ENVIRON string
  479.                     [2]  The TREEWALK.INI configuration file (see below)
  480.                     [3]  The parms on the TW command line
  481.     
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.           Page: 8 of 39 --------------------- Last Revised: 10/13/92
  498.  
  499.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  500.  
  501.  
  502.     Using TREEWALK.INI to Change Defaults:
  503.     -------------------------------------
  504.     
  505.             Starting with V2.20 (and higher), you can alter the display
  506.     colors used in TW.EXE (note that if you use the "/M" parameter in
  507.     either the ENVIRON or on the command line, TW.EXE will ignore any
  508.     color values it may find in TREEWALK.INI.
  509.     
  510.             Starting with V3.00, you may also change the default file
  511.     viewer / editor (the default is "LIST").  You can either specify a
  512.     different default program file name to use in TREEWALK.INI, or use
  513.     "ASK" to force TW to always ask you, on a case-by-case basis, which
  514.     file viewer / editor (and what command line parms) to use.  See
  515.     further instructions in the TREEWALK.INI specimen file, included.
  516.     
  517.             Note that the "ASK" parm may be set in the TREEWALK.INI file
  518.     or in the DOS ENVIRON or on the TW command line.  The command line
  519.     will override BOTH.  However, only by using TREEWALK.INI can you
  520.     specify a *particular* program file name to use as the normal default
  521.     within TW other than "LIST".  If you do specify a different program
  522.     name in TREEWALK.INI, TW will also allow you to enter any command
  523.     line parms you may desire.
  524.     
  525.             If you DO use "ASK", you will be able to enter any program
  526.     file name, any .BATch file name, or even internal DOS commands.  If
  527.     you enter COMMAND (or 4DOS) you can get a DOS shell.  Be aware that
  528.     any file handling commands you may use while in a DOS shell will NOT
  529.     automatically update TW's FILE MANAGER screen display when you
  530.     return.  See also the "/" command in FILE MANAGER.
  531.     
  532.             If you do NOT wish to alter the default configuration, I
  533.     suggest that you either delete or rename the TREEWALK.INI file which
  534.     came with this package.  This will help speed up (slightly) the time
  535.     it takes for TW to get "up and running".
  536.     
  537.             If you wish to alter the default color configuration, you
  538.     should use any text file editor (note that the editor you use MUST
  539.     end each line with a "hard" carriage return/line feed pair (hex
  540.     0D0A).  I also suggest that you keep an unaltered backup copy
  541.     of TREEWALK.INI available for any later use you may have.
  542.     
  543.             Simply type over the numeric value at the start of each line
  544.     in the TREEWALK.INI file which you wish to change.  TW.EXE will use
  545.     this new color value the next time you load it.
  546.     
  547.     NOTE: - TREEWALK.INI cannot be renamed - if you do rename this file,
  548.             TW.EXE will ignore it.  Also, TREEWALK.INI *must* be located
  549.             somewhere on your current DOS PATH.  It need NOT be located
  550.             in the same directory as TW.EXE.
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.           Page: 9 of 39 --------------------- Last Revised: 10/13/92
  560.  
  561.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  562.  
  563.  
  564.     The Initial Screen:
  565.     ------------------
  566.     
  567.             After you have started TW.EXE, a screen similar to the
  568.     following will appear:
  569.     .....................................................................
  570.     
  571.     Drive F: Has 10 Directories  SaveTree        Files    Bytes    %
  572.     
  573.     F:\[ROOT]                                      9  4,274,605  52.4%
  574.     ├────FAM_ANL ................................ 38    327,162   4.0%
  575.     │    ├────BETTY                              115    911,363  11.2%
  576.     │    ├────CINDY                                6     37,675   0.5%
  577.     │    ├────GREG                                10     72,899   0.9%
  578.     │    ├────JADA                                20    149,579   1.8%
  579.     │    ├────LARRYR                               3     15,241   0.2%
  580.     │    └────MIKE                                28    200,881   2.5%
  581.     └────GRAPHICS................................ 34  1,318,974  16.2%
  582.          └────GIFS                                17    851,795  10.4%
  583.     
  584.     
  585.     
  586.      F1 │ F2  │ F3  │ F4  │ F5  │  F6  │  F7  │ F8  │ F9  │ F10
  587.     Help│MkDir│Drive│RmDir│Paths│Search│Delete│Print│Stats│ Load
  588.     
  589.     .....................................................................
  590.     
  591.             This screen starts by telling you, in the upper left hand
  592.     corner, which drive is being used (in this example, drive F:) and how
  593.     many directories are currently on the drive (including the ROOT).
  594.     
  595.     
  596.             The "SaveTree" is a reminder that the TREE structure data is
  597.     being written to disk - this will *ALWAYS* appear unless you specifed
  598.     the "/NS" option at start up or in the DOS "TREEWALK=" parm (you also
  599.     can toggle this feature on and off during execution of TW - see the
  600.     F1 HELP menu for details - but since it has *ALREADY* saved the two
  601.     files at this point, this has limited value unless you subsequently
  602.     change drives from within TW.EXE).
  603.     
  604.     
  605.             Next to "SaveTree" may (or may not) appear a similar little
  606.     reminder, "ReadTree", which refers to whether or not you specified
  607.     the "/R" parm on the command line parm or in the DOS ENVIRON
  608.     "TREEWALK=" parm (the one which forces a physical re-read of the DOS
  609.     TREE structure).  If you see the "ReadTree", the physical disk read
  610.     operation *IS* being forced;  if you don't, TW.EXE is relying on the
  611.     "TW!.DAT" and the "TW!!.DAT" files.  You can toggle this function on
  612.     and off - see the F1 HELP menu for details.
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.           Page: 10 of 39 --------------------- Last Revised: 10/13/92
  622.  
  623.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  624.  
  625.  
  626.     Initial Screen (continued):
  627.     ---------------------------
  628.     
  629.             The column labelled "FILES" tells you how many files are
  630.     currently in each directory.  This count includes hidden files, but
  631.     does not include subdirectories (if any).
  632.     
  633.             The column labelled "BYTES" tells you the total bytes
  634.     contained in all the files in each directory.  Note that this figure
  635.     is merely the total of the file sizes as reported in the DOS
  636.     directory listing - it does not have anything to do with the number
  637.     of bytes contained in all the clusters occupied by files.  Note that,
  638.     if a cluster size for your disk is 2,048 bytes (this does vary by
  639.     hard disk and by DOS version) and you have a file which is 10 bytes
  640.     long, the column labeled "BYTES" reports the file size as 10, not
  641.     2,048.
  642.     
  643.             The rightmost column is labelled "%" (hey, I ran out of
  644.     screen columns, OK?!) and is derived as follows:
  645.     
  646.     
  647.             Total number of bytes in files (not in file-occupied
  648.                    clusters) in the individual directory)
  649.             ----------------------------------------------------
  650.             Total number of bytes in all files (again not in file
  651.                         clusters) on the entire disk
  652.     
  653.     
  654.             Note that, by definition, the sum of all these percentages
  655.     will always be = 100%.
  656.     
  657.             This is intended as a measure of which directories have the
  658.     most files and/or bytes in them so that you can manage the entire
  659.     disk instead of just individual directories.
  660.     
  661.             NOTE:   The columns labelled "FILES", "BYTES" and "%" are
  662.                     always updated after every file operation you perform
  663.                     within TW, so that they are always current no matter
  664.                     what.
  665.     
  666.                     This is useful so that you can immediately examine
  667.                     the effects of any file COPY or MOVE or DELETE
  668.                     operations in "real-time".  The downside is that it
  669.                     takes a few seconds to do, but I feel it's worth it!
  670.     
  671.             The hilite bar will be located on either the current default
  672.     directory or on the root, depending on whther you used the "[d:]"
  673.     parm at startup time, and whatever the current default directory for
  674.     the given drive happens to be.
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.           Page: 11 of 39 --------------------- Last Revised: 10/13/92
  684.  
  685.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  686.  
  687.  
  688.     Initial Screen (continued):
  689.     ---------------------------
  690.     
  691.             The bottom two screen rows contain the available functions,
  692.     most of which are available from the FKeys (those which are not
  693.     available from FKeys can be found in the F1 - HELP screen).  More on
  694.     all of these below.  When you are at this TREE MANAGER level of TW,
  695.     you can exit the program in either of two ways:
  696.     
  697.     
  698.         Press ESC to return to your original start up drive and path.
  699.     
  700.                                      OR
  701.     
  702.         Press ENTER to exit to the currently hilited drive and path.
  703.     
  704.     
  705.         NOTE:  If you have used the F4 (RmDir) function to delete the
  706.         PATH from which you started TreeWalk, you will not be able to
  707.         exit by pressing ESC (since the start-up PATH no longer exists!).
  708.         In this case, move the hilite bar to another PATH and press
  709.         ENTER.
  710.     
  711.     
  712.         NOTE:  When you attempt to exit, TW will check drives "A"
  713.         and "B" to see if they are "ready", but does not check any other
  714.         drive spec.  TW assumes that any other drive will *always* be
  715.         "ready".
  716.     
  717.     
  718.         NOTE:  TW V3.00 is the first to recognize and handle HIDDEN
  719.         sub-directories as well as regular sub-directories.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.           Page: 12 of 39 --------------------- Last Revised: 10/13/92
  746.  
  747.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  748.  
  749.  
  750.     Using the TREE Manager:
  751.     ----------------------
  752.     
  753.             After you get to the Initial Screen, you can begin to use the
  754.     TREE MANAGER section of TW.EXE.  (Note that if you started TW using
  755.     the optional "." parm, you should skip to the section below named
  756.     "Using The FILE MANAGER").
  757.     
  758.             The hilite bar can be moved to any of the various directories
  759.     by using the UP arrow, the DOWN arrow, the HOME key and the END key.
  760.     If the directory listing is too long to fit on the screen, you can
  761.     also try using the PGUP and PGDN keys.
  762.     
  763.             As an alternative, you can use the built-in "quicksearch"
  764.     feature - press the key corresponding to the first letter in the
  765.     directory name you want.  The hilite bar will immediately move to the
  766.     first directory which starts with the letter you pressed.  Press it
  767.     again to go to the next directory name starting with that letter, and
  768.     so on.
  769.     
  770.     
  771.         NOTE: This "quicksearch" only searches forward, not backward, and
  772.               does not wrap around when it hits the end.  I happen to
  773.               like it that way, but if I get enough complaints, I'll
  774.               change it!
  775.     
  776.     
  777.             If you press the ENTER key, you will immediately CHDIR to the
  778.     hilited directory entry, and exit to DOS in that drive and directory.
  779.     If you press the ESC key, you will exit to DOS in your original
  780.     startup drive and directory.
  781.     
  782.             Other functions are available from the FKey "menu" on the
  783.     bottom two screen rows, as follows:
  784.     
  785.     
  786.     F1      - HELP - on line "help" giving brief descriptions of what all
  787.             the available functions are in the TREE MANAGER section of
  788.             TW.EXE.
  789.     
  790.     
  791.     F2      - MKDIR - similar to the DOS MKDIR, except that the directory
  792.             will be created automatically as a subdirectory of whatever
  793.             directory the hilite bar is currently on.  You never need to
  794.             type a "\" character using this approach!  Note you must be
  795.             in the ROOT to create a subdirectory from the ROOT.
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.           Page: 13 of 39 --------------------- Last Revised: 10/13/92
  808.  
  809.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  810.  
  811.  
  812.     Using the TREE Manager(continued):
  813.     ---------------------------------
  814.     
  815.             - Using this function will automatically turn ON the
  816.             "ReadTree" function, and will automatically update the
  817.             TW!.DAT and TW!!.DAT files.
  818.     
  819.     
  820.     F3      - DRIVE - allows you to change the drive which TW is using.
  821.             A sub-menu of available drives will be presented, and you can
  822.             choose from ONLY those drive letters which appear by pressing
  823.             the corresponding letter key.
  824.     
  825.     
  826.     F4      *** {DIFFERENT BEHAVIOR FROM V1.2A} ***
  827.             - RMDIR - this removes the currently hilited directory, BUT
  828.             IS DIFFERENT from the DOS RMDIR command.  If the directory is
  829.             empty, it is simply deleted (see NOTE below).  TW corrects
  830.             the info in "TW!.DAT" and "TW!!.DAT" automatically for the
  831.             next time out, and sets the "ReadTree" function to "on".
  832.     
  833.             - If the directory is NOT empty, you will be asked if it is
  834.             OK to delete all the files first.
  835.     
  836.             CAUTION: - TW can (and will) delete any file, whether Hidden,
  837.             Read-Only, or whatever (but not a sub directory entry)!  File
  838.             attributes can be altered from the FILE MANAGER section of
  839.             TW, using the F9 key function menu (described below).
  840.     
  841.             - If you say OK to delete all files, TW deletes all the files
  842.             WITHOUT asking for any further confirmation, and then removes
  843.             the directory itself, then corrects the info in "TW!.DAT" and
  844.             "TW!!.DAT" automatically for the next time out.
  845.     
  846.             - NOTE:  TW cannot remove a directory entry if that directory
  847.             currently has any open sub-directory entries, even if those
  848.             sub directory entries contain no files.
  849.     
  850.             - NOTE:  TW can (and will) remove the specified directory
  851.             even if it happens to be the current default directory (after
  852.             deleting all the files), and this behavior differs from
  853.             V1.2A.  (Not even TW can remove the ROOT directory under any
  854.             circumstances!)
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.           Page: 14 of 39 --------------------- Last Revised: 10/13/92
  870.  
  871.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  872.  
  873.  
  874.     Using the TREE Manager(continued):
  875.     ---------------------------------
  876.     
  877.             - If you start TW from a given sub-directory, and then use F4
  878.             to delete it, you will NOT be able to exit TW by pressing the
  879.             ESC key (since the drive and path you started from no longer
  880.             exist).  You MUST move the hilight bar to a new path and
  881.             press ENTER to exit TW in this circumstance.
  882.     
  883.     
  884.     F5      - PATHS - this is a toggle to control how the directory
  885.             entries are displayed.  The default is to display a graphic
  886.             tree structure;  press this key to get the actual DOS PATH
  887.             NAMES for each directory.  This non-graphical display of DOS
  888.             PATH NAMES is useful when you want to print the directory
  889.             data but your printer won't handle graphics characters (see
  890.             F5, below).
  891.     
  892.             - This is useful in training inexperienced users how to
  893.             visualize a DOS TREE from a list of actual DOS PATH names (or
  894.             vice versa).
  895.     
  896.     
  897.     F6      - SEARCH - this invokes a GLOBAL SEARCH for a filespec which
  898.             you will be asked to provide.  This allows you to search an
  899.             entire disk for any particular file (DOS wildcards are
  900.             accepted and recognized appropriately) and it steps thru each
  901.             directory (starting at the ROOT) for any and all matching
  902.             files.
  903.     
  904.             - Each time a match is found, you will be given the option of
  905.             either LOADing the matching files in that directory (see F10,
  906.             below) or of merely continuing the search.
  907.     
  908.             - Note that this search will wrap-around to the ROOT after
  909.             exhausting all other directories, in case you want to "go
  910.             back" to a previously-found match.  If not, just press ESC.
  911.     
  912.     
  913.     F7      - DELETE - similar to F6, above, except that TW will attempt
  914.             to GLOBALLY DELETE all files which match your given file
  915.             spec.
  916.     
  917.             - When the first match is found, you are given the option to
  918.             say [Y]es, [N]o, [A]ll matches, or [Q]uit.
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.           Page: 15 of 39 --------------------- Last Revised: 10/13/92
  932.  
  933.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  934.  
  935.  
  936.     Using the TREE Manager(continued):
  937.     ---------------------------------
  938.     
  939.             NOTE: Using the [A] option will causes TW to delete all
  940.             matching files in all directories without asking any further
  941.             confirmation - USE THIS WITH CARE!  The best use I have found
  942.             for this is in removing the host of .BAK and .TMP files
  943.             created as intermediate files by several different software
  944.             packages.
  945.     
  946.             - CAUTION:  TW can delete any file, regardless of whether it
  947.             is Hidden, Read-Only, etc.  Note that file attributes can be
  948.             changed from the FILE MANAGER section of TW, using the F9 key
  949.             function menu (described below).
  950.     
  951.     
  952.     F8      - PRINT - This will send a copy of the TREE data currently
  953.             displayed on the screen to the printer.
  954.     
  955.             NOTE:  This routine assumes that your printer can print
  956.             graphics characters.  If it can't, (and TW will warn you
  957.             about this at run-time!) the results will be "less than
  958.             satisfactory".
  959.     
  960.             HINT:  If your printer cannot handle graphics characters, try
  961.             using the F5 key (see above) to change the screen display to
  962.             the actual DOS PATH names and then use this F8 print
  963.             function.  The DOS NAMES display contains no graphics
  964.             characters when it is printed.
  965.     
  966.     
  967.     F9      - STATS - (same as pressing the TAB key) This provides you
  968.             with a quick insight into the current status of your hard
  969.             drive, by providing a popup window containing the following
  970.             info:
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.           Page: 16 of 39 --------------------- Last Revised: 10/13/92
  994.  
  995.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  996.  
  997.  
  998.     Using the TREE Manager(continued):
  999.     ---------------------------------
  1000.     
  1001.                     ╓─────────────────────────────────────────────────╖
  1002.                     ║       [*] Disk Statistics for Drive C: [*]      ║
  1003.                     ╟─────────────────────────────────────────────────╢
  1004.                     ║    # Bytes per sector:                   512    ║
  1005.                     ║    # Sectors per cluster:                  4    ║
  1006.                     ║    Total # clusters on disk:          16,335    ║
  1007.                     ║    # Clusters unused on disk:          4,424    ║
  1008.                     ║    % Clusters available on disk:        27.1%   ║
  1009.                     ║    # Bytes in avail. clusters:     9,060,352    ║
  1010.                     ║    # Files on disk:                      937    ║
  1011.                     ║    # Bytes used by files:         23,262,096    ║
  1012.                     ║    Total # bytes on disk:         33,454,080    ║
  1013.                     ║    # Bytes unused on disk:        10,191,984    ║
  1014.                     ║    % Bytes available on disk:           30.5%   ║
  1015.                     ║    Current System Date:           10-01-1992    ║
  1016.                     ║    Current System Time:             12:12:28    ║
  1017.                     ║                                                 ║
  1018.                     ║        <*> Press Any Key To Continue <*>        ║
  1019.                     ╙─────────────────────────────────────────────────╜
  1020.     
  1021.                     - Note that the above info compares the number of
  1022.                     bytes found in files (as measured by the DOS file
  1023.                     size) against the number of bytes contained in
  1024.                     clusters.  Be aware that DOS allocates your disk
  1025.                     space in cluster-sized chunks (a file 10 bytes long
  1026.                     occupies 1 entire cluster, or 2,048 bytes (512 per
  1027.                     sector times 4 sectors per cluster) in the above
  1028.                     example).
  1029.     
  1030.                     - The only thing you have available for new files is
  1031.                     the item labelled above as "# Bytes in avail.
  1032.                     clusters" (in the above example, 9,060,352).
  1033.     
  1034.                     - By comparing the "# Bytes unused on disk" to the "#
  1035.                     Bytes in avail. clusters", you can get a
  1036.                     quick-and-dirty handle on the "slack" space on your
  1037.                     disk (i.e., the space allocated to files by DOS which
  1038.                     is not filled by the files themselves).
  1039.     
  1040.     
  1041.     F10     - LOAD - This causes TW.EXE to invoke the FILE MANAGER, and
  1042.             load all the files in the currently hilited directory.  See
  1043.             "FILE MANAGER" section, below.
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.           Page: 17 of 39 --------------------- Last Revised: 10/13/92
  1056.  
  1057.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1058.  
  1059.  
  1060.     Using the FILE MANAGER:
  1061.     ----------------------
  1062.     
  1063.             Unlike V1.2A, the current V3.00 is sensitive to the DOS
  1064.     "COMSPEC=" environment variable.  This variable is normally set by
  1065.     DOS whenever you start up your system, and exists to inform DOS how
  1066.     to execute a DOS SHELL.  If you are curious, just type the command
  1067.     SET <enter> at the DOS prompt to see how many other things are being
  1068.     stored as ENVIRON variables.
  1069.     
  1070.     
  1071.             Regular PC-DOS and MS-DOS normally set the COMSPEC= to be
  1072.     "COMSPEC=[d:\path\]COMMAND.COM", indicating that COMMAND.COM is to be
  1073.     invoked in response to any request for a DOS shell.  On the other
  1074.     hand, 4DOS and NDOS would set COMSPEC=[d:\path\]4DOS.COM or
  1075.     COMSPEC=[d:\path\]NDOS.COM, respectively.
  1076.     
  1077.     
  1078.             TW V3.00 reads this COMSPEC variable when it starts up to
  1079.     determine what features are to be available to the user.  If it finds
  1080.     4DOS or NDOS in the COMSPEC variable, it will automatically activate
  1081.     the special TW features which deal with file commenting.
  1082.     
  1083.     
  1084.             NOTE:  - TW relies on the functionality inherent in the
  1085.             4DOS / NDOS programs to provide its own extra features, and
  1086.             changing your COMSPEC variable manually won't alter this.
  1087.             You cannot obtain true file commenting capability by simply
  1088.             changing your COMSPEC= variable!
  1089.     
  1090.     
  1091.             Keeping this in mind, the following section outlines TW
  1092.     functions for FILE MANAGEMENT, and will clearly label the functions
  1093.     which are available ONLY under 4DOS / NDOS.
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.           Page: 18 of 39 --------------------- Last Revised: 10/13/92
  1118.  
  1119.                                                                                                  TreeWalk (TW.EXE) - V3.00 - User Documentation
  1120.  
  1121.  
  1122.                                                                                         The following is an example of the screen display shown when you invoke
  1123.                                                                                 the FILE MANAGER section of TW.EXE:
  1124.                                                                                 
  1125.                                                                                                          *** Running Regular DOS ***
  1126.                                                                                 ...............................................................................
  1127.                                                                                                      [*] C:\QB\*.* contains 21 file(s) [*]
  1128.                                                                                 UFiles Marked - COUNT:     0                    Files Marked - BYTES:         0
  1129.                                                                                                  .            0 11-06-1990 12:17    /   /   /   /DIR
  1130.                                                                                                  .            0 11-06-1990 12:17    /   /   /   /DIR
  1131.                                                                                          INCLUDE .            0 11-06-1990 12:18    /   /   /   /DIR
  1132.                                                                                          LIB     .            0 11-06-1990 12:17    /   /   /   /DIR
  1133.                                                                                          PROGS   .            0 11-06-1990 12:18    /   /   /   /DIR
  1134.                                                                                          BC      .EXE     77175 02-27-1991 14:40 ARC/   /   /   /
  1135.                                                                                          BCOM45  .LIB    220919 09-28-1988 01:43    /   /   /   /
  1136.                                                                                          BQLB45  .LIB     24789 09-28-1988 01:07    /   /   /   /
  1137.                                                                                          OPT     .CFG       281 06-27-1991 14:50    /   /   /   /
  1138.                                                                                          OPT     .EXE     84764 11-15-1989 11:30 ARC/   /   /   /
  1139.                                                                                          PP      .CFG       136 11-17-1989 08:24    /   /   /   /
  1140.                                                                                          PP      .EXE     75048 11-10-1989 16:02 ARC/   /   /   /
  1141.                                                                                          PREQLB  .EXE     80817 06-12-1991 10:44 ARC/   /   /   /
  1142.                                                                                  F1   │  F2   │  F3   │  F4   │  F5   │  F6   │  F7   │  F8   │  F9   │  F10
  1143.                                                                                 Help  │ Copy  │ Move  │ View  │ Mark  │ Mask  │ Delete│ Print │Change │  Sort
  1144.                                                                                 
  1145.                                                                                 ===============================================================================
  1146.                                                                                 
  1147.                                                                                      *** Running 4DOS / NDOS, and the hidden file "DESCRIPT.ION" exists ***
  1148.                                                                                 ...............................................................................
  1149.                                                                                                      [*] C:\QB\*.* contains 21 file(s) [*]
  1150.                                                                                 UFiles Marked - COUNT:     0                    Files Marked - BYTES:         0
  1151.                                                                                         .            0 11-06-1990 12:17
  1152.                                                                                         .            0 11-06-1990 12:17
  1153.                                                                                 INCLUDE .            0 11-06-1990 12:18
  1154.                                                                                 LIB     .            0 11-06-1990 12:17
  1155.                                                                                 PROGS   .            0 11-06-1990 12:18
  1156.                                                                                 BC      .EXE     77175 02-27-1991 14:40 Command line QB compiler
  1157.                                                                                 BCOM45  .LIB    220919 09-28-1988 01:43 QB Library for stand-alone .EXE files
  1158.                                                                                 BQLB45  .LIB     24789 09-28-1988 01:07 Support module for QuickLibs
  1159.                                                                                 DESCRIPT.ION       737 01-21-1992 15:28
  1160.                                                                                 OPT     .CFG       281 06-27-1991 14:50 Config file for "OPT.EXE"
  1161.                                                                                 OPT     .EXE     84764 11-15-1989 11:30 QB Source file optimizer
  1162.                                                                                 PP      .CFG       136 11-17-1989 08:24 Config file for "PP.EXE"
  1163.                                                                                 PP      .EXE     75048 11-10-1989 16:02 Pre-Processor for QB source files
  1164.                                                                                 PREQLB  .EXE     80817 06-12-1991 10:44 See info in "PREQLB.DOC"
  1165.                                                                                   F1   │  F2   │  F3   │  F4   │  F5   │  F6   │  F7   │  F8   │  F9   │  F10
  1166.                                                                                  Help  │ Copy  │ Move  │ View  │ Mark  │ Mask  │ Delete│ Print │Change │  Sort
  1167.                                                                                 ...............................................................................
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.                                                                                            Page: 19 of 39 --------------------- Last Revised: 10/13/92
  1180.  
  1181.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1182.  
  1183.  
  1184.     Using the FILE MANAGER(continued):
  1185.     ----------------------------------
  1186.     
  1187.             In both cases above, the following is shown on the screen,
  1188.     starting at the top:
  1189.     
  1190.             - The name of the current drive and path which TW is
  1191.             displaying, along with a count of all files TW found.
  1192.     
  1193.             - On the far left of the next line, the letter "U" indicates
  1194.             that the file listing is Unsorted (you can change this using
  1195.             the F10 function - see below).
  1196.     
  1197.             - Next is the number of files you currently have MARKed (see
  1198.             the F5 function, below) and the sum of bytes in all the files
  1199.             you have MARKed.
  1200.     
  1201.             - Following this is a complete listing of all directory
  1202.             entries contained in the drive and path (mainly files, but
  1203.             also includes sub-directory names).
  1204.     
  1205.             Note that the file listing displays information on ALL files,
  1206.     including Hidden, Read-Only, etc files presented in a format which is
  1207.     similar to the DOS DIR format, but the right side also tells you the
  1208.     either the current status of each file's attribute byte (under
  1209.     regular DOS) or the contents of the file's 4DOS / NDOS comment.  Note
  1210.     that, under 4DOS / NDOS, you can toggle the display to match the one
  1211.     presented under regular DOS if you wish (press the "." key).
  1212.     
  1213.             Under the regular DOS file listing format, the right-hand
  1214.     side of the listing is a literal representation of the file's current
  1215.     attribute byte (you can change the attribute byte using the F9
  1216.     function, below.   Also, the F5 file MARKing function can key in on
  1217.     this value).
  1218.     
  1219.             If a file had all attributes set, the righthand side of the
  1220.     line would read "ARC\R-O\HID\SYS".  You can interpret this as
  1221.     follows:
  1222.     
  1223.             - If ARC appears, the ARCHIVE attribute is SET
  1224.             - If R-O appears, the file is READ ONLY
  1225.             - If HID appears, the file is HIDDEN
  1226.             - If SYS appears, the file is a SYSTEM file (like IBMBIO.COM)
  1227.             - If DIR appears on the far right, then the entry is not a
  1228.             file at all, but is rather a DIRectory entry.
  1229.     
  1230.             The hilite bar can be moved in the same way as in the TREE
  1231.     MANAGER section, above.
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.           Page: 20 of 39 --------------------- Last Revised: 10/13/92
  1242.  
  1243.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1244.  
  1245.  
  1246.     Using the FILE MANAGER(continued):
  1247.     ----------------------------------
  1248.     
  1249.             The FKey menu appears again on the bottom two screen rows,
  1250.     offering the following functions:
  1251.     
  1252.     
  1253.     F1      - HELP - on line help (brief descriptions of what functions
  1254.             are available in this FILE MANAGER section of TW.EXE).
  1255.     
  1256.             - Note that contents of the actual HELP screen will vary
  1257.             depending on whether you are running regular DOS or 4DOS /
  1258.             NDOS.
  1259.     
  1260.             - Note that the help screen also contains information on
  1261.             other TW functions which are not attached to FKeys.
  1262.     
  1263.     
  1264.     F2      - COPY - allows you to copy either a single file or a group
  1265.             of files (see F5 file MARKing function, below) to another
  1266.             directory and / or drive.  You will asked to enter the
  1267.             desired destination, which will be checked to insure that it
  1268.             is a valid destination, AND that the destination is not the
  1269.             same as the source.
  1270.     
  1271.             - Unlike DOS, you may type the name of a *new* sub-directory
  1272.             as the destination if you want TW to try to create it
  1273.             (subject to the same limitations as the DOS MKDIR command).
  1274.             Also unlike DOS, TW does NOT support FILE RENAME during a
  1275.             COPY operation.
  1276.     
  1277.             - As each file is copied, the destination is checked to be
  1278.             sure that enough space exists to safely copy the file.  In
  1279.             the case of a hard disk, the copy will abort if there is not
  1280.             enough room.  If the destination is a floppy diskette (i.e.,
  1281.             drive A: or B:), you will be given the option of replacing
  1282.             the diskette if it becomes "full" rather than simply aborting
  1283.             the whole copy procedure.
  1284.     
  1285.             HINT: - You may wish to sort the file listing (see F10 below)
  1286.                     to control the order in which files are copied so as
  1287.                     to minimize the number of floppy diskettes needed.
  1288.     
  1289.     
  1290.     F3      - MOVE - same as the F2 COPY operation, above, except that
  1291.             after the file(s) are successfully copied to the destination,
  1292.             the source files are deleted (you will NOT be asked to
  1293.             confirm this deletion before it occurs).  You cannot RENAME a
  1294.             file during a MOVE.
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.           Page: 21 of 39 --------------------- Last Revised: 10/13/92
  1304.  
  1305.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1306.  
  1307.  
  1308.     Using the FILE MANAGER(continued):
  1309.     ----------------------------------
  1310.     
  1311.     F4      - VIEW/EDIT - same as using the ENTER key - the behavior of
  1312.             this option will vary depending on whether you have elected
  1313.             to invoke the "/ASK" option either from the DOS "TREEWALK="
  1314.             ENVIRON string, the TREEWALK.INI file, or the TW command
  1315.             line.
  1316.     
  1317.             - If you have NOT used "/ASK", the default action will invoke
  1318.             an external file viewing program named "LIST" and pass it the
  1319.             name of the currently hilited file as an argument.  You will
  1320.             not be asked for any other command line parms for "LIST".
  1321.     
  1322.             - Note that Vern Buerg's LIST.COM is highly recommended and
  1323.             widely available from any BBS in the country (just about) but
  1324.             is not included with TW.
  1325.     
  1326.             - If you HAVE invoked "/ASK", pressing F4 or ENTER will
  1327.             present you with a dialog window asking you which program to
  1328.             use.  Pressing ENTER alone assumes you want to use LIST, but
  1329.             you can type the name of any program file, .BATch file, or
  1330.             internal (4)DOS command (including, by the way, COMMAND or
  1331.             4DOS or NDOS, which will invoke a DOS shell from within TW's
  1332.             FILE MANAGER).  See also above page 9 for further info.
  1333.     
  1334.             - If the program file you want to use requires its own
  1335.             command line parms BEFORE the file name (eg, PKZIP) you
  1336.             should type them in after the program name, then press ENTER.
  1337.     
  1338.             - The hilited file name will be added to the command line you
  1339.             have typed, and displayed for you.  You will now have the
  1340.             opportunity to add any additional command line parms which
  1341.             are supposed to come AFTER the hilited file name (press ENTER
  1342.             for none, or ESC to quit here).
  1343.     
  1344.             - Finally, the completed command line you have entered will
  1345.             be displayed for you, and you will be asked whether TW should
  1346.             pause after completion before returning.  This is useful if
  1347.             the program itself outputs to the display screen - note that,
  1348.             if the final output is less than a full screen, TW will
  1349.             immediately erase it and return UNLESS you answer Y to this
  1350.             "pause" option.
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.           Page: 22 of 39 --------------------- Last Revised: 10/13/92
  1366.  
  1367.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1368.  
  1369.  
  1370.     Using the FILE MANAGER(continued):
  1371.     ----------------------------------
  1372.     
  1373.             - If you are not sure whether to use Y or N, try Y first.
  1374.             Note that, even at this point, ESC will quit the whole
  1375.             process.
  1376.     
  1377.             NOTE: - If the program or function you choose affects the
  1378.                     file listing in TW's currently displayed FILE MANAGER
  1379.                     screen, TW will NOT automatically detect this and
  1380.                     update its display.  If this is a problem, ESCape
  1381.                     from the FILE MANAGER, and re-enter (F10) the
  1382.                     directory from the TREE MANAGER.
  1383.     
  1384.     
  1385.     F5      - MARK - be aware that all file operations (i.e., COPY, MOVE,
  1386.             DELETE, etc) within TW can act on either a single file (the
  1387.             currently hilited file name) or on a group of files which you
  1388.             define.  Note that the second row of the FILE MANAGER screen
  1389.             always displays the number of files which have been MARKed,
  1390.             as well as the total number of bytes in all MARKed files.
  1391.     
  1392.             - Within TW, there are several ways to MARK a group of files.
  1393.             The simplest is to move the hilite bar to each filename you
  1394.             want and then press the "+" key.  If you make a mistake,
  1395.             hilite the file name and press the "+" key again.
  1396.             - But TW offers you several other ways to MARK a group of
  1397.             files.  When you press the F5 function key, the FKey menu on
  1398.             the bottom two screen rows changes to offer you the following
  1399.             functionalities (and be aware that MARKing operations are
  1400.             cumulative - to MARK all files with the EXT = .FMT and/or
  1401.             .WK1, simply use F6 twice - once for each extension.  To
  1402.             ERASE all MARKs, use F5 then F9):
  1403.     
  1404.             F1 - on line help describing what the other keys do when you
  1405.                  are MARKing files.
  1406.     
  1407.             F2 - ATTRIB - allows you to MARK all files which share a
  1408.                  common file attribute (see above page 18).  You will be
  1409.                  asked to specify which attribute you want to use as a
  1410.                  MARK criterion.
  1411.     
  1412.             F3 - DATE - allows you to MARK all files which have a file
  1413.                  date within a given range of dates that you will be
  1414.                  asked to specify (between START and STOP date).
  1415.     
  1416.             F4 - SIZE - allows you to MARK all files which are within a
  1417.                  range of files sizes that you will have to specify
  1418.                  (lower size limit -> upper size limit).
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.           Page: 23 of 39 --------------------- Last Revised: 10/13/92
  1428.  
  1429.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1430.  
  1431.  
  1432.     Using the FILE MANAGER(continued):
  1433.     ----------------------------------
  1434.     
  1435.             F5 - NAME - allows you to MARK all files which CONTAIN a
  1436.                  string of characters which you will specify.
  1437.     
  1438.                - This is NOT the same as DOS, since if you specify the
  1439.                  string "THE", for example, TW will MARK files named:
  1440.                  THEO.FIL OTHER.FIL SSSTHES.FIL
  1441.     
  1442.                - Note that wildcards are NOT allowed here.
  1443.                - Note that the EXTENSION is ignored here, so that in this
  1444.                  example, the file "XXXX.THE" would NOT be MARKed (but
  1445.                  see below F6).
  1446.     
  1447.             F6 - EXT - allows you to mark all files which match the three
  1448.                  letter EXTENSION which you will be asked to specify.
  1449.     
  1450.             F7 - CURRENT - toggles the MARK state of the currently
  1451.                  hilited filename (same as "+").
  1452.     
  1453.             F8 - +ALL - MARKs all files
  1454.     
  1455.             F9 - -ALL - UNMARKs all files
  1456.     
  1457.             F10 - REVERSE - toggles the MARK state of all files - all
  1458.                   files which are currently MARKed will become UNMARKed,
  1459.                   and vice versa.
  1460.     
  1461.     
  1462.     F6      - MASK - Allows you to control which filenames are displayed.
  1463.             You will be asked to specify a legal DOS filespec (wildcards
  1464.             are allowed) and then only the matching files will be
  1465.             displayed in the FILE MANAGER screen window.  If any files
  1466.             have been MARKed (via the F5 function, above), you will be
  1467.             asked if OK to remove all MARKs before changing the MASK.
  1468.     
  1469.             - This is helpful is have a *lot* of files in your directory
  1470.             and you want to see just a subgroup of matching files on
  1471.             the screen at one time.
  1472.     
  1473.             - If you just press ENTER here, the file mask will revert to
  1474.             its default of *.* (show everything!).
  1475.     
  1476.             NOTE: - The file note editing features of TW (for users of
  1477.                     4DOS / NDOS) are not active unless the file "mask" is
  1478.                     "*.*", which is the default.  However, file notes
  1479.                     will still be displayed on the screen for your
  1480.                     reference (unless you press the "." key).
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.           Page: 24 of 39 --------------------- Last Revised: 10/13/92
  1490.  
  1491.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1492.  
  1493.  
  1494.     Using the FILE MANAGER(continued):
  1495.     ---------------------------------
  1496.     
  1497.     F7      - DELETE - Allows you to delete a single file or group of
  1498.             MARKed files (same as DEL key)
  1499.     
  1500.             NOTE:  - TW.EXE can and will delete any file regardless of
  1501.             whether it is Hidden, Read-Only, etc.  However, this DEL (F7)
  1502.             function cannot delete a sub-directory entry.
  1503.     
  1504.             NOTE: - The 4DOS / NDOS "DESCRIPT.ION" file will NOT be
  1505.                     updated until you EXIT the FILE MANAGER.
  1506.     
  1507.             CAUTION: If you press this key, the currently hilited file
  1508.                      will be deleted WITHOUT ASKING FOR CONFIRMATION
  1509.                      UNLESS you have MARKed any file(s) (even one), in
  1510.                      which case you WILL be asked to confirm the delete.
  1511.     
  1512.     
  1513.     F8      - PRINT - sends the currently displayed list of filenames to
  1514.             the printer.
  1515.             HINT: - Use the F6 MASK function to control which filenames
  1516.                     go to the printer.
  1517.     
  1518.             NOTE: - The file listing will be numbered on the left hand
  1519.                     side of the printout IF you are *not* printing the
  1520.                     4DOS / NDOS file comments.  An asterisk ("*")
  1521.                     will be printed after the number to alert you if a
  1522.                     file note exists but was not printed.
  1523.     
  1524.     
  1525.     F9      - CHANGE - Invokes the Fkey menu of file change functions
  1526.             (all of which except for F10 operate on either the single,
  1527.             currently hilited filename, or on the currently MARKed group
  1528.             of iles), defined as follows:
  1529.     
  1530.             F1 - on line help of what the other keys do within the File
  1531.                  Change function
  1532.     
  1533.             F2 - SET the Archive attribute for the file(s)
  1534.     
  1535.             F3 - SET the Read-Only attribute for the file(s)
  1536.     
  1537.             F4 - SET the Hidden attribute for the file(s)
  1538.     
  1539.             F5 - SET the System attribute for the file(s)
  1540.     
  1541.             F6 - CLEAR the Archive attribute for the file(s)
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.           Page: 25 of 39 --------------------- Last Revised: 10/13/92
  1552.  
  1553.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1554.  
  1555.  
  1556.     Using the FILE MANAGER(continued):
  1557.     ---------------------------------
  1558.     
  1559.             F7 - CLEAR the Read-Only attribute for the file(s)
  1560.     
  1561.             F8 - CLEAR the Hidden attribute for the file(s)
  1562.     
  1563.             F9 - CLEAR the System attribute for the file(s)
  1564.     
  1565.             F10 - change the name of the currently hilited filename
  1566.     
  1567.     
  1568.     F10     - SORT - allows you to SORT the displayed listing of
  1569.             filenames in the following ways (which you will be asked to
  1570.             specify):
  1571.     
  1572.                     ASCENDING order by File NAME
  1573.                     ASCENDING order by File EXTENSION
  1574.                     DESCENDING order by File Date
  1575.                     DESCENDING order File Size
  1576.                     UNSORTED (the original DOS directory order)
  1577.     
  1578.     
  1579.     "/"     - The SLASH key suspends operation of TW.EXE and invokes a
  1580.             DOS shell.  The success of this depends on the "COMSPEC="
  1581.             string in the DOS ENVIRON, so that if you are running DOS,
  1582.             you get a DOS shell;  if you are running 4DOS, you get a 4DOS
  1583.             shell; ditto for NDOS.
  1584.     
  1585.             NOTE: - If you use any DOS commands which affect the file
  1586.                     listing for the current directory, TW will not
  1587.                     automatically update the FILE MANAGER display screen
  1588.                     when you type EXIT to return to TW.
  1589.                     If this causes you a problem, press ESC to return to
  1590.                     the TREE MANAGER, and then press F10 to re-enter the
  1591.                     desired sub directory; this will cause TW to update
  1592.                     the FILE MANAGER display.
  1593.     
  1594.             NOTE: - When you SHELL to DOS, be aware that TW is still in
  1595.                     memory, and is using approx 240K of your system's
  1596.                     RAM.  Therefore, if you try to run a LARGE program,
  1597.                     you may not have enough free RAM to succeed.
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.           Page: 26 of 39 --------------------- Last Revised: 10/13/92
  1614.  
  1615.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1616.  
  1617.  
  1618.     Using the FILE MANAGER(continued):
  1619.     ---------------------------------
  1620.             Those of you using 4DOS / NDOS will also find the following
  1621.     keys active (and they also appear on your F1 help screen):
  1622.     
  1623.     TAB     - Allows you to create / edit / delete the current 4DOS /
  1624.             NDOS file comment.  Key usage instructions are on the screen
  1625.             in Edit dialog box.  This function is active ONLY when you
  1626.             are viewing ALL files in the directory (i.e., "*.*" on F6).
  1627.     
  1628.     
  1629.     "       - The QUOTES key alows you to copy the file comment from the
  1630.             currently hilighted filename to any other file(s) you wish.
  1631.             Simply press the " key (no need to use the SHIFT) and a popup
  1632.             box will appear to tell you that you are copying a file note.
  1633.             At the same time, a blinking letter "C" will appear in the
  1634.             upper right hand corner of the screen to remind you that a
  1635.             file comment has been copied to the TW internal clipboard.
  1636.     
  1637.             - Bring the hilight bar down to the file name to which you
  1638.             wish to copy the note, and press the " key again.  If the
  1639.             file to which you are copying the file comment already has an
  1640.             existing comment of its own, you will be asked to confirm the
  1641.             overwrite.  If no comment currently exists, the file comment
  1642.             will be immediately copied to the currently hilited file.
  1643.     
  1644.             - Be aware that the TW file comment clipboard retains its
  1645.             contents so that you can copy the file note to more than one
  1646.             file if you wish.  To clear out the clipboard, try to copy
  1647.             the clipboard note to any file which already has an existing
  1648.             file comment, and press the " key.  You will be asked to
  1649.             confirm the replacement of the existing file comment with the
  1650.             new one - press [Q] or [ESC] to erase the clipboard, or just
  1651.             [N] to cancel the file comment copy but retain the TW file
  1652.             comment clipboard contents.
  1653.     
  1654.     
  1655.     "."     - The PERIOD key allows you to toggle the format of the file
  1656.             listing from the 4DOS / NDOS comment format to the "regular
  1657.             DOS" format (which displays the file attribute byte values).
  1658.     
  1659.             NOTE: Pressing the period key will have no effect unless
  1660.             there is a file containing file notes (named "DESCRIPT.ION").
  1661.     
  1662.             NOTE: It is perfectly OK to enter and edit file notes (if you
  1663.             are using 4DOS or NDOS) even when you are not currently
  1664.             viewing them - however, I think you'll find it preferable to
  1665.             display the file notes before doing any editing!  If you are
  1666.             in doubt, press the period key at any point.  It can't hurt!
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.           Page: 27 of 39 --------------------- Last Revised: 10/13/92
  1676.  
  1677.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1678.  
  1679.  
  1680.     Program Limitations:
  1681.     -------------------
  1682.     
  1683.             In version 3.00, the following limitations are known (and if
  1684.     you find any others, please let me know - if there's enough interest,
  1685.     I'll be happy to try to revise and / or customize TW.EXE.  Remember,
  1686.     feedback is everything!):
  1687.     
  1688.     
  1689.     <>      SORTing the list of files in the FILE MANAGER is not as fast
  1690.             as I'd like, *especially* when you sort by date.  If any of
  1691.             you know any real good sort algorhythms for ASCII
  1692.             "MM/DD/YYYY", please let me know!
  1693.     
  1694.     <>      Not enough different options on the FILE SORT menu.
  1695.     
  1696.     <>      If your hard disk contains more than 300 directories /
  1697.             subdirectories per drive you're out of luck!
  1698.     
  1699.     <>      If any single directory contains more than 700 files, you're
  1700.             out of luck!  (But why would you DO this to yourself?)
  1701.     
  1702.     <>      All printing routines make no assumption as to type of
  1703.             printer and are formatted at 60 lines per page and 80 or 82
  1704.             characters per line.  This provides a more-or-less plain
  1705.             vanilla print style, but it's more likely to work on all
  1706.             printers, from EPSON to HP to ...?
  1707.             Note that you can set printer setup strings using the 
  1708.             "TREEWALK.INI" file to take advantage of "fancier" print
  1709.             styles if you wish.
  1710.     
  1711.     <>      4DOS / NDOS file notes are assumed to be <= 40 characters,
  1712.             even though the most recent version of 4DOS allows you to
  1713.             make the file notes longer than this.  If you already have
  1714.             a file note longer than 40 characters, TW will truncate the
  1715.             note to 40 characters.  (40 has always been enough for me, at
  1716.             least!)
  1717.     
  1718.     <>      TW cannot recognize a "STACKER" type drive (sorry!).  In
  1719.             addition, although I have not specifically tested, I think TW
  1720.             will not work with ANY non-DOS-standard drive (eg, SuperStor)
  1721.             and with the Norton Utilities "secure" directories;  TW DOES
  1722.             work with most RAM-drives.
  1723.     
  1724.     <>      If your DOS "PATH=" ENVIRON string contains more than 50
  1725.             different PATHs, TW.EXE will be unable to find (and therefore
  1726.             unable to use) the TREEWALK.INI file.
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.           Page: 28 of 39 --------------------- Last Revised: 10/13/92
  1738.  
  1739.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1740.  
  1741.  
  1742.     Tech Notes:
  1743.     ----------
  1744.     
  1745.             TW.EXE requires a CGA / EGA / VGA adapter card, since it uses
  1746.     screen write routines which address RAM memory locations directly.
  1747.     If the video RAM in your system does not start at B800:0000 (which is
  1748.     the case for a lot of monochrome video boards), you cannot use TW.
  1749.     
  1750.     
  1751.             TW.EXE was written primarily using Microsoft BASIC PDS V7.1
  1752.     but includes 28 separate (original) sub-routines written entirely in
  1753.     assembler which provide functionalities lacking in BASIC.  I used
  1754.     Microsoft MASM V5.1 / V6.0 to assemble all these routines.
  1755.     
  1756.     
  1757.             I'll happily answer any specific questions you may have about
  1758.     the program code / logic / etc - please use CompuServe electronic
  1759.     mail, or send me a regular letter or postcard.  Please do NOT call me
  1760.     on the telephone.  I have been known to distribute partial source
  1761.     code so if you are interested, let me know!
  1762.     
  1763.     
  1764.             The TW.EXE file distributed herein has been compressed using
  1765.     the "LZEXE.EXE" program.  This compression conserves space on your
  1766.     hard disk, and reduces your download time, but in certain instances
  1767.     can present problems (or so I hear).  Do not hesitate to uncompress
  1768.     TW.EXE (use UNLZEXE.EXE) if you wish.
  1769.     
  1770.     
  1771.     
  1772.     
  1773.     
  1774.     
  1775.     
  1776.     
  1777.     
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.           Page: 29 of 39 --------------------- Last Revised: 10/13/92
  1800.  
  1801.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1802.  
  1803.  
  1804.     Revision History:
  1805.     ----------------
  1806.     
  1807.     
  1808.     Version 2.00
  1809.     ------------
  1810.     
  1811.             was first released to the public on 01/27/92, and was hastily
  1812.     withdrawn following user feedback that it *really* didn't work on
  1813.     their machine.  This lead to my discovering that MS-DOS INT 25h does
  1814.     not result in standard responses on certain machines (notably COMPAQ
  1815.     386, ZEOS 386, etc - thanks Dianne and Mark!).
  1816.     
  1817.             After fixing this "bug", V2.00 was re-released on 02/06/92
  1818.     with revised documentation.  I found out that the DOS INT 25h "bug"
  1819.     still persisted under somewhat more rare conditions.
  1820.     
  1821.     
  1822.     Version 2.01
  1823.     ------------
  1824.     
  1825.             was first released to the public on 02/11/92, and hopefully
  1826.     that DOS INT 25h problem is now squashed once and for all.
  1827.     
  1828.             V2.01 first included the ability to set program parameters
  1829.     from either the command line or from a DOS ENVIRON parm.
  1830.     
  1831.     
  1832.     Version 2.20
  1833.     ------------
  1834.     
  1835.             was first released 07/27/92, and included some bug fixes:
  1836.             - The problem with editing 4DOS/NDOS file notes being
  1837.     EXACTLY 40 characters is gone.
  1838.             - The problem of TW "forgetting" your file sort order when
  1839.     you deleted multiple files is gone.
  1840.     
  1841.             V2.20 was the first to allow the user to customize display
  1842.     colors by using the TREEWALK.INI file.
  1843.     
  1844.             V2.20 increased the maximum number of sub-directories per
  1845.     system from 100 to 200, and provided error-checking to prevent any
  1846.     "hangs" (which occurred in previous versions).
  1847.     
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.           Page: 30 of 39 --------------------- Last Revised: 10/13/92
  1862.  
  1863.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1864.  
  1865.  
  1866.     Version 3.00
  1867.     ------------
  1868.     
  1869.             was first released to the public on 10/13/92 
  1870.             - This release was a substantial re-write of most of the TW
  1871.     source program, using new routines for handling files which allowed
  1872.     me to increase the number of sub-directories per drive (I was amazed
  1873.     at how many folks out there have *huge* hard drives with more than
  1874.     200 sub-directories!)  The current limit is 300 subdirectories per
  1875.     drive.
  1876.     
  1877.             - V3.00 recognizes and handles HIDDEN sub-directories.
  1878.     
  1879.             - V3.00 has some real improvements in the area of screen
  1880.     scroll performance (especially when viewing large directories of
  1881.     files using the UP and DOWN arrow keys).
  1882.     
  1883.             - V3.00 also contains numerous enhancements to existing
  1884.     routines.  In previous versions, when dealing with many of the
  1885.     file-handling functions, TW had a "habit" of returning you to the
  1886.     very top of the file list after performing the desired function.
  1887.     This tendency has been minimized (no, not completely eliminated!) in
  1888.     V3.00.
  1889.     
  1890.             - V3.00 also allows you to specify a different default
  1891.     program to use during the file view/edit function (ENTER or F4)
  1892.     within the FILE MANAGER area, along with customized command line
  1893.     parms, if any are desired.  This feature also allows a DOS shell from
  1894.     within TW's FILE MANAGER (and there is also an actual "DOS SHELL"
  1895.     feature available as well).
  1896.     
  1897.     
  1898.     Next version:
  1899.     ------------
  1900.     
  1901.             What, exactly, do YOU want to see TW do?
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.           Page: 31 of 39 --------------------- Last Revised: 10/13/92
  1924.  
  1925.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1926.  
  1927.  
  1928.                                  APPENDIX A
  1929.     
  1930.       Quick Reference to TreeWalk V3.00 Parameters (ALL are OPTIONAL)
  1931.       ---------------------------------------------------------------
  1932.     
  1933.             In general, TW will evaluate and implement your desired
  1934.     options in the following sequence:
  1935.     
  1936.                     [1]  The "TREEWALK=" DOS ENVIRON string
  1937.                     [2]  The TREEWALK.INI configuration file (see below)
  1938.                     [3]  The parms on the TW command line
  1939.     
  1940.     
  1941.     Parameter       Explanation                        Available From
  1942.     Literal         of Function                     Comm Line / ENVIRON
  1943.     
  1944.     D: or .         Drive to use at start up              Y   /   N
  1945.                     (colon is optional)
  1946.     
  1947.     /25,/43,/50     Start TW in 25,43,or 50 row mode      Y   /   Y
  1948.                     (highest value rules)
  1949.     
  1950.     
  1951.     /R              Force TW to physically read           Y   /   Y
  1952.                     disk TREE structure
  1953.     
  1954.     
  1955.     /NS             Force TW to NOT write the             Y   /   Y
  1956.                     TW!.DAT and TW!!.DAT files to disk
  1957.     
  1958.     /? or /HELP     Display summary of parms on screen    Y   /   N
  1959.     
  1960.     /M              Start TW in MONOCHROME mode           Y   /   Y  (1)
  1961.     
  1962.     /ASK            Force TW to "ask" you how to
  1963.                     VIEW / EDIT files in FILE MANAGER     Y   /   Y  (2)
  1964.     
  1965.     
  1966.     /NOASK          Force TW to ignore "ASK" in the
  1967.                     TREEWALK.INI file                     Y   /   Y  (3)
  1968.     
  1969.     
  1970.     (1)     Use of /M will override any color statements in TREEWALK.INI.
  1971.             Use of /M in ENVIRON cannot be overridden on Command Line.
  1972.     
  1973.     (2)     ASK can also be placed in the TREEWALK.INI file if desired.
  1974.     
  1975.     (3)     In the TREEWALK.INI file, NOASK is the same as LIST.
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.           Page: 32 of 39 --------------------- Last Revised: 10/13/92
  1986.  
  1987.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  1988.  
  1989.  
  1990.                                  APPENDIX B
  1991.     
  1992.                    Map of Colors used in TREEWALK.INI File
  1993.                    ---------------------------------------
  1994.     
  1995.             The purpose of this Appendix is to give you a clearer idea of
  1996.     what screen display items will be affected when you make changes in
  1997.     the color values in the TREEWALK.INI file.
  1998.     
  1999.     
  2000.     Line 1 = ClrScrnColor
  2001.     ---------------------
  2002.     
  2003.             - This color value is used in all screen clearing (analogous
  2004.             to CLS) instructions.
  2005.             - You will see it as a "border" around the TREE MANAGER, and
  2006.             on its top line.  Similarly, you will see it as a "border"
  2007.             around the FILE MANAGER, and on its top two lines.
  2008.             - You also see it on the opening screen when TreeWalk reads
  2009.             the disk directory structure.
  2010.             - Changes here should be considered in conjunction with Lines
  2011.             12 and 13, below.
  2012.             - The DEFAULT value = 23 (Grey on Blue).
  2013.     
  2014.     Line 2 = RegTreeColor
  2015.     ---------------------
  2016.     
  2017.             - This color value is used for the display of the DOS PATH
  2018.             names or graphical TREE structure within the TREE MANAGER.
  2019.             - The DEFAULT value = 48 (Black on Cyan).
  2020.     
  2021.     Line 3 = BoxColor1
  2022.     ------------------
  2023.     
  2024.             - This color value is primarily in screen dialog boxes as the
  2025.             color of informational text displayed to you.
  2026.             - It is also used as the color used to clear screen dialog
  2027.             boxes (like CLS for a "box" area).
  2028.             - It is also used to erase the "<*> Press Any Key ..." text.
  2029.             - Finally, it is used as the hilite color for the DOS PATH
  2030.             names / TREE structure displayed under the hilite bar in the
  2031.             TREE MANAGER.
  2032.             - The DEFAULT value is 112 (Black on White/Grey).
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.           Page: 33 of 39 --------------------- Last Revised: 10/13/92
  2048.  
  2049.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  2050.  
  2051.  
  2052.     Line 4 = BoxColor2
  2053.     ------------------
  2054.     
  2055.             - This color value is used as the secondary color of text
  2056.             displayed in screen dialog boxes.
  2057.             - It is also used as the hilite color for the DOS PATH
  2058.             statistics (# Files and # Bytes) for the DOS PATH curerntly
  2059.             under the hilite bar in the TREE MANAGER.
  2060.             - The DEFAULT value = 113 (Blue on White/Grey).
  2061.     
  2062.     Line 5 = BoxBorderColor
  2063.     -----------------------
  2064.     
  2065.             - This color value, as its name implies, is used primarily
  2066.             for the "lines" used in drawing the various screen dialog
  2067.             boxes.
  2068.             - The DEFAULT value = 120 (Light Black on White/Grey).
  2069.     
  2070.     Line 6 = BlinkColor
  2071.     -------------------
  2072.     
  2073.             - This color value is used for screen messages, generally
  2074.             found in dialog boxes, which "blink" to call your attention
  2075.             to them.  These include messages such as "<*> Press Any
  2076.             Key...", "Please Wait", "One Moment, please...", etc
  2077.             - The DEFAULT value = 241 (Blinking Blue on White/Grey).
  2078.     
  2079.     Line 7 = FKeyMenuColor
  2080.     ----------------------
  2081.     
  2082.             - As you might expect, this color value controls the color in
  2083.             which the normal FKEY menu is displayed on the bottom two
  2084.             screen rows.
  2085.             - Note that Secondary FKEY menus (those displayed, for
  2086.             example, after you press F5 or F9 in the FILE MANAGER) are
  2087.             controlled by the "HiLiteFileColor" variable, below, line 10.
  2088.             - The DEFAULT value = 113 (Blue on White/Grey)
  2089.     
  2090.     Line 8 = RegFileColor
  2091.     ---------------------
  2092.     
  2093.            - This value is used in the display of file info in the FILE
  2094.            MANAGER section.  It is used for bothe the file names, sizes,
  2095.            etc, as well as either the attribute string or the file note
  2096.            data.
  2097.            - This is also the color used in screen clearing (CLS)
  2098.            functions in the FILE MANAGER.
  2099.            - The DEFAULT value = 48 (Cyan on Black).
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.           Page: 34 of 39 --------------------- Last Revised: 10/13/92
  2110.  
  2111.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  2112.  
  2113.  
  2114.     Line 9 = CurrRegFileColor
  2115.     -------------------------
  2116.     
  2117.             - This color is used to display file data in the FILE MANAGER
  2118.             section for the file which is currently under the hilite bar.
  2119.             - The DEFAULT value = 112 (Black on White/Grey).
  2120.     
  2121.     Line 10 = HiLiteFileColor
  2122.     -------------------------
  2123.     
  2124.             - This color value is used to to display file info in the
  2125.             FILE MANAGER section for those files which have been MARKed
  2126.             for COPY, MOVE, DELETE, etc.
  2127.             - This color is also used for the secondary FKey menus (such
  2128.             as those displayed in the FILE MANAGER when you press F5 or
  2129.             F9).  See also Line 7, above.
  2130.             - The DEFAULT value = 14 (Bright Yellow on Black).
  2131.     
  2132.     Line 11 = CurrHiLiteFileColor
  2133.     -----------------------------
  2134.     
  2135.             - This color value controls the color of MARKed files in the
  2136.             FILE MANAGER display on which the hilite bar is currently
  2137.             resting.
  2138.             - The DEFAULT value = 126 (Bright Yellow on White/Grey).
  2139.     
  2140.     Line 12 = TitleTextColor
  2141.     Line 13 = AltTitleTextColor
  2142.     ---------------------------
  2143.     
  2144.             - These two color values control the information which is
  2145.             displayed on the top row of the TREE MANAGER, and the top two
  2146.             rows of the FILE MANAGER.
  2147.             - Changes to these colors should be considered in conjunction
  2148.             with Line 1, above.
  2149.             - The DEFAULT for TitleTextColor = 30 (Bright Yellow on Blue)
  2150.             - The DEFAULT for AltTitleTextColor = 31 (Bright White on
  2151.             Blue)
  2152.     
  2153.     Line 14 = TreeStatsColor
  2154.     ------------------------
  2155.     
  2156.             - This color value is used for the display of the "# Files"
  2157.             and "# Bytes" in each of the DOS PATHs displayed in the TREE
  2158.             MANAGER.  The DEFAULT value = 3 (Cyan on Black).
  2159.     
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.           Page: 35 of 39 --------------------- Last Revised: 10/13/92
  2172.  
  2173.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  2174.  
  2175.  
  2176.     Line 15 = WarningColor
  2177.     ----------------------
  2178.     
  2179.             - This color is used for various warning messages which
  2180.             generally appear in dialog boxes.  Examples would be messages
  2181.             warning you of impending file deletions, directory deletions,
  2182.             etc.
  2183.             - The DEFAULT = 116 (Red on White/Grey).
  2184.     
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.           Page: 36 of 39 --------------------- Last Revised: 10/13/92
  2234.  
  2235.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  2236.  
  2237.  
  2238.                                  APPENDIX C
  2239.     
  2240.                  Using Printer Control Codes in TREEWALK.INI
  2241.                  -------------------------------------------
  2242.     
  2243.     
  2244.             Lines 18 through 22 in the TREEWALK.INI file are used to
  2245.     allow you to customize the hard-copy printouts provided by TW.EXE
  2246.     from its F8 function keys.  (Note that Line 17 is RESERVED.)
  2247.     
  2248.     
  2249.             Please understand that this section is entirely optional -
  2250.     you can leave lines 18 - 22 blank if you wish.  This section is
  2251.     strictly for those who would like to enhance their TW printouts.
  2252.     
  2253.     
  2254.             You should be familiar with the concept of printer control
  2255.     code strings before you continue.  These are, basically, a string
  2256.     of characters which you can send to your printer to alter the way
  2257.     it prints (eg, setting italics, or emphasized print, etc).  The
  2258.     Owner's Manual for your printer should contain a reference table of
  2259.     printer control codes for your particular model of printer.  This
  2260.     Appendix will include examples for EPSON (and compatible) printers,
  2261.     as well as for Hewlett Packard LJ Series II (and compatible)
  2262.     printers.
  2263.     
  2264.     
  2265.             In this section of the TREEWALK.INI file, all printer control
  2266.     codes are entered as strings of 3-digit ASCII characters seperated by
  2267.     blank spaces.  This is similar to the format used by Lotus 1-2-3
  2268.     (except that Lotus 1-2-3 uses the "\" character to seperate the
  2269.     3-digit codes while TW uses a blank space).  The ESC character
  2270.     (used to start many of the control code strings) is represented by
  2271.     the string 027 (see examples below).
  2272.     
  2273.     
  2274.             Line 18 should contain the control codes for the type of
  2275.     print you want to see in the "Title" lines of the print out.  (HINT:
  2276.     You may also want to include the control codes to get your printer to
  2277.     use graphics characters, if your printer supports this function but
  2278.     is not set this way as a default).
  2279.     
  2280.             As an example, lets assume you want to see the titles in BOLD
  2281.     ITALIC style of typeface.  The appropriate line 18 in TREEWALK.INI
  2282.     would be:
  2283.     
  2284.     EPSON (and compatible):  027 069 027 052
  2285.     HP LJ II (compatibles):  027 040 115 049 083 027 040 115 051 066
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.           Page: 37 of 39 --------------------- Last Revised: 10/13/92
  2296.  
  2297.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  2298.  
  2299.  
  2300.             Line 19 in TREEWALK.INI should contain printer control codes
  2301.     to cancel anything and everything you set in line 18.  Line 19 should
  2302.     "turn OFF" any special printer characteristics you "turned ON" in
  2303.     line 18.  Following the example we set above, if we set BOLD ITALIC
  2304.     in line 18, our line 19 should be:
  2305.     
  2306.     EPSON (and compatible):  027 070 027 053
  2307.     HP LJ II (compatibles):  027 040 115 048 083 027 040 115 048 066
  2308.     
  2309.     ---------------------------------------------------------------------
  2310.     
  2311.             The remaining lines affect the way the printout of data (as
  2312.     opposed to page title info) is printed.  As a general rule, I
  2313.     strongly urge you avoid using printer control codes which set
  2314.     proportional font spacing (since the printout won't look very good!).
  2315.     Stick with fixed-space fonts.  Note that Lines 20 and 21 are NOT used
  2316.     the TW TREE MANAGER printout;  they are used in the TW FILE MANAGER
  2317.     only.
  2318.     
  2319.     
  2320.             Line 20 (see also note below for line 21) in TREEWALK.INI
  2321.     should contain the printer codes for the printing of the FILE data
  2322.     from the FILE MANAGER printouts.  If you wanted, for example, to see
  2323.     the file name, size, date, and time printed as being underlined, use
  2324.     the following:
  2325.     
  2326.     EPSON (and compatible):  027 045 001
  2327.     HP LJ II (compatibles):  027 038 100 068
  2328.     
  2329.     
  2330.             Line 21 in TREEWALK.INI should contain the control codes to
  2331.     use for printing the file's attribute string (or, for 4DOS/NDOS
  2332.     users, the file note info).
  2333.     
  2334.             NOTE:  Any printer changes you make in Line 20 will continue
  2335.             into the printing of the current file's note or
  2336.             attribute unless you specifically turn them off here.
  2337.     
  2338.             NOTE:  Any printer changes you make in Line 21 will continue
  2339.             into the printing of the next line's file name data unless
  2340.             you turn it off here.
  2341.     
  2342.     
  2343.             For example, in the above line 20, you set the underline
  2344.     feature to be "turned on".  The underlining will continue into the
  2345.     printing of the file note or attribute unless you use Line 21 to
  2346.     "turn off" the underlining again.
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.           Page: 38 of 39 --------------------- Last Revised: 10/13/92
  2358.  
  2359.                 TreeWalk (TW.EXE) - V3.00 - User Documentation
  2360.  
  2361.  
  2362.             If you wanted to print the file attribute or note data in
  2363.     12cpi (for example) but without underlines you should set Line 21 as
  2364.     follows:
  2365.     
  2366.     EPSON (and compatible):  027 045 000 027 077
  2367.     HP LJ II (compatibles):  027 038 100 064 027 038 107 052 083
  2368.     
  2369.             Note that both the above examples start by turning OFF the
  2370.     underline feature, and then turning ON the 12 CPI feature.
  2371.     
  2372.             Note that the 12 CPI feature will STAY ON for the printing of
  2373.     the next line's file name, size, date, and time UNLESS you use line
  2374.     20 to "turn off" the 12 cpi feature.  You could do this by adding the
  2375.     following to each of the above example Line 20's:
  2376.     
  2377.     EPSON (and compatible):  027 080
  2378.     HP LJ II (compatibles):  027 038 107 048 083
  2379.     
  2380.     ---------------------------------------------------------------------
  2381.             The above discussion probably is more complicated than it
  2382.     needs to be.  You should try different combinations on your own
  2383.     printer to determine which printing style enhancements work best for
  2384.     you.  Note that, as I said before, if you wish, you can leave these
  2385.     five lines blank and TW will still print just fine (just not fancy!).
  2386.             Note, too, that the actual control codes you use are limitted
  2387.     only by your imagination, and by your printer's capabilities!
  2388.     ---------------------------------------------------------------------
  2389.     
  2390.             Line 22 should contain the control code needed to reset
  2391.     (sometimes called "initialize") your printer.  This causes the
  2392.     printer to do a "soft" reset - equivalent to switching the printer
  2393.     off, and then back on.
  2394.     
  2395.             This code is sent after each TW printout in order to cancel
  2396.     any and all of the codes you may have set in Lines 18, 19, 20, and 21
  2397.     - in effect, this will "clean out" your printer (i.e., make it as it
  2398.     was before you used TW to print anything).  These codes are as
  2399.     follows:
  2400.     
  2401.     EPSON (and compatible):  027 064
  2402.     HP LJ II (compatibles):  027 069
  2403.     
  2404.     
  2405.     
  2406.     
  2407.     
  2408.     
  2409.     ========================= [ END OF TW.DOC ] =========================
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.           Page: 39 of 39 --------------------- Last Revised: 10/13/92